home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 007 / d86.arc / TROUBLE.DOC < prev   
Text File  |  1986-11-16  |  6KB  |  120 lines
  1. ---TROUBLE.DOC---
  2.  
  3. If D86 does not work properly on your system, I would like to hear about it.
  4.  
  5. If you saw no debugger screen at all when you tried executing D86 HEXOUT,
  6. try D86 -V HEXOUT.  Let me know what happens then.
  7.  
  8. I have written a tool called D86CHECK, that outputs information about your
  9. computer system.  Please run D86CHECK to get that information.  If you are
  10. sending me a letter in the mail, you can direct output to your printer;
  11. e.g., D86CHECK >PRN.  If you are sending me a disk, or a message on the
  12. bulletin board, you can redirect output to a file; e.g. D86CHECK >OUTFILE.
  13.  
  14. Give me the output to D86CHECK, and tell me as much as you can about the
  15. problems you are experiencing.  Also tell me the brand and model of your
  16. computer.  I'll try to see to it that the problem is fixed.
  17.  
  18. Again, I receive BBS mail at (812)824-7990 and (812)332-7227.  My address is:
  19.  
  20.    Eric Isaacson
  21.    416 E. University Street
  22.    Bloomington, IN 47401
  23.  
  24. Guide for more sophisticated users, to get D86 running on a non-compatible
  25.  
  26. This document outlines what I need to know about your computer in order to get
  27. D86 running on it.  The quickest way you'll get D86 up on your computer is to
  28. write an A86 program that performs the functions I am about to describe; and
  29. then send me the source to that program.  If you do not feel up to actually
  30. writing the program yourself, then you can send me sufficient documentation
  31. about your computer, that would let me write such a program.  If you do not know
  32. where such documentation exists, ask your computer dealer or your user's group.
  33.  
  34. IMPORTANT NOTE: My efforts in porting D86 are done with the understanding that
  35. you will become a registered user.  I would prefer that you register in advance;
  36. if this makes you nervous, then I will accept a written promise from you that
  37. you will register when I get D86 working on your machine.  (Advance registrants
  38. will get the fastest turnaround.)  I will grant Sysop-status to those of you
  39. who are the first to write the program for your machine: i.e., if you can
  40. persuade five other users to register (and mention your name when they do so),
  41. I'll refund your registration.
  42.  
  43. Here is what the A86 program should do:
  44.  
  45. 1. The program should examine memory to identify your machine.  Preferably the
  46.    identification should come from the last 11 bytes of the megabyte memory
  47.    space, at 0F000:0FFF5.  If the program is NOT running on your brand of
  48.    machine, then it should exit without doing anything.  NOTE: the program
  49.    D86CHECK.COM in the D86 package will identify the 11 bytes; it may also
  50.    assist you in finding video memory.
  51.  
  52. 2. The program should ring the computer's bell.
  53.  
  54. 3. The program should move the blinking cursor to the bottom left corner of
  55.    the screen.
  56.  
  57. 4. The program should call the BIOS keyboard input routine, to return a single,
  58.    non-line-edited keystroke.  The program should map function keys and special
  59.    keys as shown in the chart at the end of this document, to obtain a single
  60.    one-byte code, no matter what key is pressed.
  61.  
  62. 5. If the key pressed was ALT-F1 (a key code of 216 decimal), the program should
  63.    exit.  Otherwise, continue.
  64.  
  65. 6. If your computer requires a special output-port sequence to enable access to
  66.    video memory, the program should output that sequence at this time.
  67.  
  68. 7. The program should fill the computer's video memory with the one-byte key
  69.    code.  The entire screen should show the character, with no special
  70.    attributes.
  71.  
  72. 8. The program should change the attribute of the second character on the third
  73.    line, to create a reverse-video character in that position.
  74.  
  75. 9. If your computer requires an output-sequence to reverse the effects of step
  76.    6, then it should issue such a sequence at this time.
  77.  
  78. 10. Go back to Step 4, to accept and display another key.
  79.  
  80.  
  81. In summary, in order to get D86 up and running on your machine as quickly as
  82. possible, you should send three things:
  83.  
  84. 1. Your registration fee for D86 (and A86, if you plan to use it).
  85. 2. The output to D86CHECK as run on your machine.
  86. 3. The A86 source to a working program as described above.
  87.  
  88.  
  89. Keyboard Mapping Chart
  90.  
  91. All ASCII characters should return their ASCII codes.  All function keys and
  92. special keys should return the sum of decimal 112 with the "auxiliary byte"
  93. value returned by IBM's BIOS.  These (decimal) values are as shown in the
  94. following chart.  So for example, the F1 key should map to 112+59 = 171 decimal.
  95.  
  96. F1         59         Alt-0      12        Shift-Tab    15
  97. .                     Alt-hyphen 130       Home         71
  98. .                     Alt-=      131       Up arrow     72
  99. F10        68                              PgUp         73
  100.                       Alt-Q      16        Left Arrow   75
  101. Shift-F1   84         Alt-W      17        Right Arrow  77
  102. .                     Alt-E      18        End          79
  103. .                     Alt-R      19        Down Arrow   80
  104. Shift-F10  93         .                    PgDn         81
  105.                       .                    Insert       82
  106. Ctrl-F1    94         Alt-P      25        Delete       83
  107. .                                          Ctrl-PrtSc  114
  108. .                     Alt-A      30        Ctrl-Left   115
  109. Ctrl-F10  103         Alt-S      31        Ctrl-Right  116
  110.                       .                    Ctrl-End    117
  111. Alt-F1    104         .                    Ctrl-PgDn   118
  112. .                     Alt-L      38        Ctrl-Home   119
  113. .                                          Ctrl-PgUp   132
  114. Alt-F10   113         Alt-Z      44
  115.                       Alt-X      45
  116. Alt-1     120         .
  117. .                     .
  118. .                     Alt-M      50
  119. Alt-9     129
  120.